home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / Sound / LAME / WarpOS / src / INSTALL < prev    next >
Encoding:
Text File  |  2001-06-12  |  5.8 KB  |  176 lines
  1. LAME 3.xx    January 2001  Mark Taylor (http://www.mp3dev.org)
  2.  
  3.  
  4. =======================================================================
  5. Compile time options
  6. =======================================================================
  7. There are serveral targets which can be built from this
  8. source code:
  9.  
  10. lame/lame.exe   The command line encoder
  11.  
  12. lame_enc.dll    a Windows DLL used by many GUIs which support lame.
  13.                 (Can only be compiled by MSVC???)
  14.  
  15. libmp3lame.a    the *NIX style encoding library
  16. libmp3lame.so   shared version of libmp3lame.a                (not yet)
  17.  
  18.  
  19. The following compile time options can be used.  For libmp3lame.a
  20. and lame_enc.dll, none are required.  On non-unix systems,
  21. these options must be set in Makefile or in the IDE.  
  22. On unix systems, they are set via ./configure.  
  23.  
  24.  
  25. #define HAVE_MPGLIB   compile in mpglib's mp3 *decoding* capibility
  26. #define HAVE_VORBIS   compile in Vorbis decoding capibility
  27.                      (you need libvorbis already built)
  28. #define NOANALYSIS   do not compile in hooks used by the 
  29.                      MP3 frame analyzer.
  30.  
  31.  
  32. Options for the command line encoder:
  33. #define LIBSNDFILE   to use Erik de Castro Lopo's libsndfile
  34.                      for input.
  35. #define BRHIST       to allow the optional display of the VBR histogram
  36.  
  37.  
  38.  
  39. =======================================================================
  40. Building the software on *NIX platforms using configure:
  41. =======================================================================
  42. Run the following commands:
  43.  
  44. % ./configure
  45. % make 
  46. % make install
  47.  
  48. For a complete list of options, try "./configure --help"
  49. Some of the more usefull options:
  50.  
  51. For the encoding library:
  52.  
  53.   --enable-mp3x               Build the mp3 frame analyzer, 'mp3x'
  54.  
  55.   --enable-mp3rtp             Build the encode-to-RTP program, 'mp3rtp'
  56.  
  57.  
  58. For the LAME front end encoder:
  59.  
  60.   --with-fileio=lame          Use lame's internal file io routines [default]
  61.                =sndfile       Use Erik de Castro Lopo's libsndfile (no stdin possible currently)
  62.  
  63.   --with-sndfile-prefix=DIR   Alternate location for libsndfile
  64.                               (if --with-fileio=sndfile)
  65.  
  66.   --enable-brhist             Include the VBR bitrate histogram feature 
  67.                               (default:yes if any ncurses/termcap available)"
  68.  
  69.  
  70. Other usefull configure options:
  71.  
  72.   --enable-debug              Build a debug version
  73.  
  74.   --enable-expopt             Enable some more optimizations flags for
  75.                               the compiler, may or may not produce
  76.                               faster code
  77.  
  78.   --prefix = PATH             default is /usr/local
  79.                               (LAME currently installs:
  80.                                 /usr/local/bin/lame
  81.                                 /usr/local/lib/libmp3lame.a
  82.                                 /usr/local/lib/libmp3lame.so
  83.                                 /usr/local/include/lame.h
  84.  
  85.  
  86.   --with-vorbis                Enable Ogg Vorbis encoding/decoding support
  87.   --with-vorbis-prefix = PATH  specify where to find Vorbis libs
  88.  
  89.  
  90. Some more advanced ways to influence the build procedure
  91. (experienced users only, use it at your own risk):
  92.  
  93.   - If you want to use some custom defines for building (e.g. some out
  94.     of the file "DEFINES") use:
  95.  
  96.      * bourne shell or compatible (ash, bash, zsh, ...):
  97.        CONFIG_DEFS="-Dmy_define" ./configure
  98.  
  99.      * C shell or compatible (csh, tcsh, ...):
  100.        setenv CONFIG_DEFS "-Dmy_define"
  101.        ./configure
  102.  
  103.   - If you want to use some additional options for the compiler:
  104.  
  105.     * bourne shell or compatible (ash, bash, zsh, ...):
  106.       CFLAGS="--my_flag" ./configure
  107.  
  108.     * C shell or compatible (csh, tcsh, ...):
  109.       setenv CFLAGS "--my_flag"
  110.       ./configure
  111.  
  112.   Or some combination of the above.
  113.  
  114.   Note:
  115.     If configure detects the presents of "nasm" some additional speed
  116.     improvements get compiled in (additional assembler code to detect
  117.     and use multimedia extensions of the used processor).
  118.  
  119.  
  120. =======================================================================
  121. Building the software on *NIX platforms without configure:
  122. =======================================================================
  123. % make -f Makefile.unix
  124.  
  125.  
  126.  
  127. =======================================================================
  128. Building the software on Windows with MSVC:
  129. =======================================================================
  130. There are MSVC project files, and a Makefile.MSVC included
  131. with the project.  For production use, be sure to compile
  132. a "Release" target, with the "maximum speed" compile
  133. option, and #define NDEBUG.   
  134.  
  135. It is possible to compile the GTK frame analyzer under windows, see
  136. README.WINGTK
  137.  
  138. Various build options can be set in configMS.h
  139.  
  140.  
  141.  
  142. =======================================================================
  143. Building the software on Windows with free compilers:
  144. =======================================================================
  145. LAME can be compiled with various Windows MSDOS ports (all free)
  146. of GCC (DJGPP, Mingw32).  See README.DJGPP.  
  147.  
  148. For Mingw32, you should now be able to use the Unix Makefile that
  149. comes with LAME.  Try: "make -f Makefile.unix UNAME=MSDOS"
  150. You may need to remove these lines from brhist.c:
  151.  
  152. #ifdef _WIN32
  153. COORD Pos;
  154. HANDLE CH;
  155. CONSOLE_SCREEN_BUFFER_INFO CSBI;
  156. #endif
  157.  
  158. Mingw32 users may also try to use the unix configure script (explained
  159. above), it has _untested_ support for Mingw32.
  160.  
  161. Cygwin users should use the unix configure script (explained above). If
  162. you have problems with the configure script try:
  163.       CC=gcc ./configure
  164. Patches to enable the build of the lame_enc.dll with Cygwin and autoconf /
  165. automake / libtool are welcome!
  166.  
  167. To use the Borland C compiler (now free!) see README.B32 and Makefile.B32.
  168. Borland can also compile the lame_enc.dll, but this is untested.
  169.  
  170. Can DJGPP or Mingw32 produce lame_enc.dll?
  171.  
  172. Various build options can be set in configMS.h
  173.  
  174.  
  175.  
  176.